home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-06 / fsl11.zip / README < prev    next >
Text File  |  1993-04-04  |  26KB  |  592 lines
  1.  
  2.  
  3.  
  4.  
  5.      FSLOGIN   Full Screen Login.
  6.  
  7.      Version 1.1, march 1993.
  8.  
  9.      A utility for all Novell NetWare users.
  10.  
  11.  
  12.  
  13.      ╔══════════════════════════════════════════════════════╗
  14.      ║           Please enter your Login Data         ║
  15.      ╠══════════════════════════════════════════════════════╣
  16.      ║                                ║
  17.      ║        Server    YOUR_SERVER..................        ║
  18.      ║                                ║
  19.      ║        Userid    YOUR_USERID..................        ║
  20.      ║                                ║
  21.      ║        Password    .............................        ║
  22.      ║                                ║
  23.      ║                          ┌──────┐        ║
  24.      ║                          │Accept│        ║
  25.      ║                          └──────┘        ║
  26.      ╚══════════════════════════════════════════════════════╝
  27.  
  28.  
  29.  
  30.      (c) Confirm 1993, The Netherlands, All rights reserved.
  31.  
  32.      Author: Aad Slingerland
  33.      
  34.      Contents of this document
  35.      =========================
  36.  
  37.      The Shareware concept
  38.  
  39.      The purpose of this program
  40.  
  41.      How to install
  42.  
  43.      How to use
  44.  
  45.      Pre-filling the fields
  46.  
  47.      Special keys
  48.  
  49.      Password expired!
  50.  
  51.      Some other features
  52.  
  53.      Some questions and answers
  54.  
  55.      Summary of changes
  56.  
  57.      Registration and support
  58.  
  59.  
  60.      Credits
  61.      =======
  62.  
  63.      It is worthwile mentioning the effort of a group of colleagues
  64.      and friends who have together done a fine job looking,
  65.      testing, talking, phoning, faxing, criticizing and cheering me
  66.      up again. They helped, and often still help FSLOGIN growing.
  67.      
  68.      The Shareware concept
  69.      =====================
  70.  
  71.      Shareware distribution gives users a chance to try software
  72.      before buying it. If you try a Shareware program and continue
  73.      using it, you are expected to register. Individual programs
  74.      differ on details. Some request registration while others
  75.      require it, some specify a maximum trial period. With
  76.      registration, you get anything from the simple right to
  77.      continue using the software to an updated program with printed
  78.      manual.
  79.      Copyright laws apply to both Shareware and commercial
  80.      software, and the copyright holder retains all rights, with a
  81.      few specific exceptions as stated below. Shareware authors are
  82.      accomplished programmers, just like commercial authors, and
  83.      the programs are of comparable quality. (In both cases, there
  84.      are good programs and bad ones!) The main difference is in the
  85.      method of distribution. The author specifically grants the
  86.      right to copy and distribute the software, either to all or to
  87.      a specific group. For example, some authors require written
  88.      permission before a commercial disk vendor may copy their
  89.      software.
  90.      Shareware is a distribution method, not a type of software.
  91.      You should find software that suits your needs, whether it's
  92.      commercial or Shareware. The Shareware system makes fitting
  93.      your needs easier, because you can try before you buy. And
  94.      because the overhead is low, prices are also low. Shareware
  95.      has the ultimate money-back guarantee -- if you don't use the
  96.      product, you don't pay for it.
  97.  
  98.      DISCLAIMER - AGREEMENT
  99.  
  100.      Users of FSLOGIN must accept this disclaimer of warranty:
  101.      "FSLOGIN is supplied as is.  The author disclaims all
  102.      warranties, expressed or implied, including, without
  103.      limitation, the warranties of merchantability and of fitness
  104.      for any purpose. The author assumes no liability for damages,
  105.      direct or consequential, which may result from the use of
  106.      FSLOGIN."
  107.      FSLOGIN is a "shareware program" and is provided at no charge
  108.      to the user for evaluation.  Feel free to share it with your
  109.      friends, but please do not give it away altered or as part of
  110.      another system.  The essence of "user-supported" software is
  111.      to provide personal computer users with quality software
  112.      without high prices, and yet to provide incentive for
  113.      programmers to continue to develop new products.  If you find
  114.      this program useful and find that you are using FSLOGIN and
  115.      continue to use FSLOGIN after a trial period of 30 days, you
  116.      must make a registration payment to Confirm.  The registration
  117.      fee will license one copy for use on any one Novell NetWare
  118.      server at any one time.  You must treat this software just
  119.      like a book.  An example is that this software may be used by
  120.      any number of people and may be freely moved from one server
  121.      location to another, so long as there is no possibility of it
  122.      being used at one location while it's being used at another.
  123.      Just as a book cannot be read by two different persons at the
  124.      same time.
  125.  
  126.      Commercial users of FSLOGIN must register and pay for their
  127.      copies of FSLOGIN within 30 days of first use or their license
  128.      is withdrawn.  Site-License arrangements may be made by
  129.      contacting Confirm.
  130.  
  131.      Anyone distributing FSLOGIN for any kind of remuneration must
  132.      first contact Confirm at the address below for authorization.
  133.      This authorization will be automatically granted to
  134.      distributors recognized by the (ASP) as adhering to its
  135.      guidelines for shareware distributors, and such distributors
  136.      may begin offering FSLOGIN immediately (However Confirm must
  137.      still be advised so that the distributor can be kept
  138.      up-to-date with the latest version of FSLOGIN.).
  139.  
  140.      You are encouraged to pass a copy of FSLOGIN along to your
  141.      friends for evaluation.  Please encourage them to register
  142.      their copy if they find that they can use it.
  143.      
  144.      The purpose of this program
  145.      ===========================
  146.  
  147.      All the PC users who are connected to a local area network
  148.      with Novell servers, have at least one thing in common. They
  149.      must login to the network, before applications and data become
  150.      available. It's obvious that this is almost always done using
  151.      the standard Novell login program. This command line utility,
  152.      however, isn't very attractive to use and does not do a fine
  153.      job, when users must be informed about network exceptions or
  154.      errors.
  155.      It is my goal to enhance the way you can login to a server, by
  156.      providing you with a full screen, Novell menu style program.
  157.      FSLOGIN is not only a different way to type some data, like
  158.      the userid and the password, but does extensive checking of
  159.      accounting and security exceptions. All kinds of reasons why a
  160.      user cannot login to a server, are presented in clear text in
  161.      a full screen window. Because the user is properly informed of
  162.      certain exceptions, he or she wil be able to communicate
  163.      better with the system administrator, instead of complaining
  164.      something like "I cannot login!".
  165.      The actual Novell login command line utility is only executed
  166.      after various checks on correctness of names, accounting and
  167.      security matters have been done. Almost nothing but a file
  168.      server that goes down at that particular moment, can go wrong
  169.      now.
  170.  
  171.      ┌──────────────────────────────────────────────┐
  172.      │               Login Status            │
  173.      ├──────────────────────────────────────────────┤
  174.      │                            │
  175.      │ The login process to the choosen file server │
  176.      │ with the choosen userid cannot be completed. │
  177.      │                            │
  178.      │ One of the security measures prevented this. │
  179.      │ You will have to contact the system admini-  │
  180.      │ strator to clear this situation.         │
  181.      │                            │
  182.      │ The precise errorcode and reason is:        │
  183.      │                            │
  184.      │ Errorcode : 197                    │
  185.      │ Reason     : intruder lockout            │
  186.      │                            │
  187.      └──────────────────────────────────────────────┘
  188.      
  189.      How to install
  190.      ==============
  191.  
  192.      Installing the Full Screen Login program can be done in three
  193.      stages, of which the first stage is required. The stages two
  194.      and three are optional, and using them depends on the
  195.      preference of the system administrator.
  196.  
  197.      The first stage installs FSLOGIN on the Novell server, and is
  198.      basically enough to make it available for use.
  199.  
  200.      The second stage is distributing one of the programs of
  201.      FSLOGIN to PC's with a local harddisk. The benefit of this is,
  202.      that this program is capable of 'finding' the SYS:LOGIN
  203.      directory, even if it is on a network drive like Z:.
  204.  
  205.      The third stage is renaming the program fslogin.com to
  206.      login.com. This makes the Full Screen Login program the one
  207.      that's always used, and you don't have to change existing
  208.      batch files, where 'login' is called.
  209.  
  210.      Stage One.
  211.      .    Execute the installation batch file (INSTALL.BAT) from
  212.     the drive and directory where the files of FSLOGIN reside.
  213.     This batch files copies the files FSLOGIN.* to the directory
  214.     SYS:LOGIN and flag them as read-only shareable.
  215.     Second the file FSLOGIN.COM is copied to the SYS:PUBLIC
  216.     directory and also flagged read-only shareable.
  217.  
  218.      !    When you are using a NetWare 2.xx server, you must grant a
  219.     trustee assignment to the group everyone, which gives this
  220.     group read and filescan rights in the SYS:LOGIN directory.
  221.  
  222.      .    That's all! Just type fslogin now.
  223.  
  224.      Stage Two.
  225.      .    Copy the program fslogin.com to the local disk of the PC's
  226.     in your network. Make sure that this program resides in a
  227.     directory, that is in the PATH variable. From that moment
  228.     on, your users will be able to login, even if they have
  229.     logged out the last time from 'some' network drive, leaving
  230.     SYS:LOGIN on 'some' network drive letter, but the first.
  231.  
  232.      Stage Three.
  233.      .    Rename FSLOGIN.COM to LOGIN.COM in both the directories
  234.     SYS:LOGIN and SYS:PUBLIC. When Stage Two has been used,
  235.     also distribute LOGIN.COM to the PC's with a harddisk.
  236.      
  237.      How to use
  238.      ==========
  239.  
  240.      Once installed, Full Screen Login is available. Just type
  241.      FSLOGIN and the Login Data menu shows up. As you can see the
  242.      name of the default server, to which the workstation is
  243.      attached is automatically placed in the Server field. For a
  244.      first exercise, fill in the name of an userid you want to use
  245.      and press the enter key. The highlight goes down to the
  246.      Password field. When there is a password defined for this
  247.      userid, fill it in and press enter again, otherwise leave this
  248.      field blank. When all datafields are oke, the highlight is on
  249.      the 'accept' button field. Press the enter key again to confirm
  250.      the complete form to the program.
  251.  
  252.      At this moment the information that has been placed in the
  253.      fields will be validated, and when something is wrong, you
  254.      will be informed. When the validation is oke, and there are no
  255.      other accounting or security restrictions, the actual Novell
  256.      login.exe will be executed. You as a system supervisor, do not
  257.      have to change anything to existing login scripts in order to
  258.      use FSLOGIN.
  259.  
  260.      When filling in the fields in the form, you might have noticed
  261.      that the Novell menu like interface expects you to acknowledge
  262.      both the data in the individual fields, as well as the form as a
  263.      whole. When entering data into a selected field (the field
  264.      with the highlight), the hardware cursor appears. When the
  265.      enter key is pressed to 'acknowledge' the data in this field,
  266.      the hardware cursor disappears and the highlight moves on to
  267.      the next field. When you want to edit the contents of a field,
  268.      without losing what is already there, move the highlight to
  269.      that field and press the Modify key (F3). There are some
  270.      alternate keys that can be used to move the highlight from one
  271.      field to anonther. Those keys are: tab, backtab, up arrow,
  272.      down arrow, home, end, page up and page down.
  273.  
  274.      See the next chapter on how to further simplify the way you
  275.      can work with FSLOGIN.
  276.      
  277.      Pre-filling the fields
  278.      ======================
  279.  
  280.      To make daily use even more simple, two of the three fields in
  281.      the Login Data form can be pre-filled. You might already have
  282.      noticed that the Server field contains the name of the server,
  283.      to which the PC is attached. This automatic filling in of a
  284.      servername should be sufficient in single server environments,
  285.      where there is nothing to choose. However, in a multiserver
  286.      environent the server to which the PC is attached is not
  287.      always the one users need access to. A DOS environment
  288.      variable can be used to specify a different name as the
  289.      default.
  290.      Type the following command at the DOS command prompt.
  291.  
  292.      SET FS_SRV=MYSERVER
  293.  
  294.      When the program is started again the Server field will
  295.      contain the string 'MYSERVER'.
  296.      Another feature available here is the ServerList function.
  297.      When the F5 key is pressed, the program reads the names of
  298.      available servers in the network and presents a list on the
  299.      screen. Just move the highlight and pick a name!
  300.  
  301.      The Userid field can be pre-filled as well with the use of
  302.      another environment variable. Type the following command at
  303.      the DOS command prompt.
  304.  
  305.      SET FS_UID=MYUSERID
  306.  
  307.      Now the Userid field will also come up with a default. When
  308.      the pre-filled values for the Server and Userid are correct,
  309.      the only thing the user has to do is type the corresponding
  310.      password and press the enter key twice. Once to acknowledge
  311.      the contents of the password field and once to acknowledge the
  312.      form as a whole with the aid of the accept button.
  313.  
  314.      There is a special form of the FS_UID variable, that can be
  315.      usefull when the userids in your organisation are highly
  316.      structured. There are companies that use not so individual
  317.      userids like ACCOUNT01, ACCOUNT02, ACCOUNT03 etc. And maybe
  318.      SALES01, SALES02 and so on. The crucks is that part of the
  319.      string always is the same. You can pre-fil this common part of
  320.      the userid by placing it in the environment variable FS_UID,
  321.      followed by a tilde. For example:
  322.  
  323.      SET FS_UID=TECHNO~
  324.  
  325.      Have a look at what happens!
  326.  
  327.      When you are the supervisor, you probably type the string
  328.      'supervisor' a thousand times a year. See the next chapter why
  329.      you shouldn't!
  330.      
  331.      Special Keys
  332.      ============
  333.  
  334.      F1=Help
  335.      You might already have used the F1 key for online help. Most
  336.      of the basics of this utility are explained here, and the
  337.      average user should have enough information to do the job. The
  338.      Arrow Up, Arrow Down, Page Up and Page Down let you scroll
  339.      through the text, and the Escape key brings you back again.
  340.  
  341.      F3=Modify
  342.      This is in fact the default Novell menu function key for
  343.      modifying the contents of a field. I considered it useful to
  344.      mention this key on the 25'th line as a reminder.
  345.  
  346.      F5=ServerList
  347.      When you are working in a multiserver environment, the
  348.      ServerList function becomes valuable. Just press this key, to
  349.      get an overview of all the file servers in your network, and
  350.      pick one. Note that using the F5 key is independent of the
  351.      currently highlighted field. It always works.
  352.  
  353.      F7=Supervisor
  354.      There is one specific userid, which is probably typed
  355.      thousands of times each day by thousands of supervisors. Just
  356.      press the F7 key and look what happens. It does not matter on
  357.      which field the highlight is. After pasting the string
  358.      'supervisor' in the Userid field, the highlight goes straight
  359.      to the password field, since this is most likely the place you
  360.      want to go.
  361.      
  362.      Password expired!
  363.      =================
  364.  
  365.      Well, in that case, this is what you get!
  366.  
  367.      ╔══════════════════════════════════════════════════════════════════╗
  368.      ║               Password Expired Status            ║
  369.      ╠══════════════════════════════════════════════════════════════════╣
  370.      ║    Your current password has expired. In order to be able to    ║
  371.      ║    login, you must specify a new one in the New Password field.    ║
  372.      ║    Retype the new password again after the Verification prompt.    ║
  373.      ║    This is a check to prevent typing errors. Your new password    ║
  374.      ║    should be at least 3 characters long.                ║
  375.      ║                                    ║
  376.      ║        New Password     ...................................    ║
  377.      ║                                    ║
  378.      ║        Verification     ...................................    ║
  379.      ║                                    ║
  380.      ║                             ┌──────┐    ║
  381.      ║                             │Accept│    ║
  382.      ║                             └──────┘    ║
  383.      ╚══════════════════════════════════════════════════════════════════╝
  384.  
  385.      This information guides the user to a new pasword.
  386.  
  387.      I should mention a special case when the so called grace logins are
  388.      used. As you will probably know the grace login feature of Novell
  389.      allows the users to login with an old password, which is in fact
  390.      expired. You could even give a user an unlimited number of grace
  391.      login's, which would have about the same effect as giving a password
  392.      an unlimited time to use. I have investigated to implement the
  393.      handling of grace logins in my program as well, but was forced to
  394.      drop it. The simple and only reason for this is, that a user with
  395.      grace login possibilities, would be prompted a second time by the
  396.      Novell login.exe program. Since I have no control of what kind of
  397.      programs the Novell login.exe runs on behalf of the system login
  398.      script, I considered it 'unstable' to programmatically 'answer' this
  399.      extra prompt. Working on this item I found out that there is no
  400.      clean solution for this.
  401.  
  402.      But that does not mean that you should throw away the grace login
  403.      options of the users. Grace logins are needed in order to be able to
  404.      change the password anyhow!
  405.      
  406.      Some other features
  407.      ===================
  408.  
  409.      Full Screen Login has a screen dimmer that activates automatically
  410.      after five minutes of keyboard inactivity. A small red box travels
  411.      around on the screen (white, green or amber if you have a monochrome
  412.      video adapter). When a key is pressed the Login Data form shows up
  413.      again.
  414.  
  415.      Full Screen Login has support for the optional parameters, that can
  416.      be passed to the system login script. There is no separate field for
  417.      this, but parameters can be typed in the Userid field after the name
  418.      of user. Leave one space between the name of the user and the
  419.      parameter. When the Userid field seems to be full, just type ahead
  420.      and see the text scroll. The combined length of the name of the user
  421.      and the optional parameters cannot exceed 64 bytes.
  422.  
  423.      FSLOGIN does not only work full screen, but is also command line
  424.      compatible with the Novell login command. The fslogin.com program
  425.      does in fact pass the command line that is typed to the login.exe
  426.      program. The advantage of using FSLOGIN is that the SYS:LOGIN
  427.      directory will be searched for and set to the first network drive
  428.      letter. No more manual searching for drive 'x'.
  429.  
  430.      FSLOGIN works with monochrome VGA monitors without manually setting
  431.      a specific video mode with the MODE command.
  432.  
  433.      Since version 1.1. a RRS (Registration Reminder Screen) has been
  434.      added. This is the small window below the Login Data window, that
  435.      contains the text 'Unregistered Evaluation Copy'. When you register
  436.      you should specify a text string that you want to appear in this
  437.      window. This text string should contain company information like the
  438.      name of the company and perheaps the name of the department who does
  439.      the registration.
  440.  
  441.      
  442.      Some questions. And some answers.
  443.      =================================
  444.  
  445.      Question 1:
  446.      When I want to use your program, do I have to throw away my existing
  447.      login scripts?
  448.  
  449.      No you dont'. Full Screen Login does not replace the Novell
  450.      login.exe and corresponding login scripts. It adds full screen
  451.      support and extensive error and exception reporting, without
  452.      throwing away your already made effort.
  453.  
  454.      Question 2:
  455.      Why is the FSLOGIN.COM the only program to copy to the SYS:PUBLIC
  456.      directory?
  457.  
  458.      In order to conserve a bit of disk space, and make eventual updates
  459.      as easy as possible to install, there'a only one place for the
  460.      overlay and other support files, and that is the SYS:LOGIN
  461.      directory. The file FSLOGIN.COM is the only one to copy to the
  462.      public directory.
  463.  
  464.      Question 3:
  465.      I just installed your product, but I receive the message:
  466.      'The FSLOGIN.OVL program could not be executed.'.
  467.  
  468.      The most probable cause is, that you run the program fslogin.com
  469.      from a local hard disk, but the server you are attached to does not
  470.      have Full Screen Login installed. Use the netx option 'PS=MYSERVER'
  471.      to make the correct server the default, or better, install Full
  472.      Screen Login on the other servers as well.
  473.  
  474.      Question 4:
  475.      I installed Full Screen Login, but when I want to use it I receive
  476.      the message:
  477.      'The LOGIN.EXE program could not be executed.'.
  478.  
  479.      Did you rename the original Novell login.exe? If yes, rename it back
  480.      or make a copy of it.
  481.  
  482.      Question 5:
  483.      I work in a large company with 257 file servers in a network. When I
  484.      use the ServerList function, there are only 255 file servers in the
  485.      list.
  486.  
  487.      The current limitation of the ServerList function is 255 names. If
  488.      this realy is a problem, please contact me.
  489.  
  490.      Question 6:
  491.      Your program does not support grace logins. What should I do with
  492.      the currently defined grace logins?
  493.  
  494.      Dont't throw away the grace option for your users! When you disable
  495.      grace logins, there will be no way the user can change the password.
  496.      Not with my program, nor with any other login program. In fact Full
  497.      Screen Login needs some grace logins to remain, in order to be able
  498.      to change the password. It's also worth mentioning, that when a user
  499.      presses the escape key in the Password Expired Status form, the
  500.      number of Grace Logins Left will be decremented by one. In fact Full
  501.      Screen Login did do a login function call once to find out that the
  502.      password had expired.
  503.  
  504.      Question 7:
  505.      During the installation, stage one, I have to add a trustee
  506.      assignment to the SYS:LOGIN directory for the group EVERYONE. Why is
  507.      this for NetWare 2.xx only?
  508.  
  509.      Because NetWare 3.11 already gives EVERYONE access to the SYS:LOGIN
  510.      directory, even after login. NetWare 2.xx did 'hide' the SYS:LOGIN
  511.      directory after login.
  512.  
  513.      
  514.      Summary of changes between 1.0 and 1.1
  515.      ======================================
  516.  
  517.      The detection of monochrome displays connected to a VGA adapter
  518.      has been improved. There have been some cases of 'grey',almost
  519.      unreadable screens on some types of machines.
  520.  
  521.      The user interaction has been enhanced by using an Accept button
  522.      field in the Login Data and the Password Expired forms. This makes
  523.      it more intuitive that the form as a whole must be acknowledges.
  524.  
  525.      A RRS (Registration Reminder Screen) has been added.
  526.      This small window will contain the name of the company and/or
  527.      department for registered users.
  528.  
  529.      An installation batch file has been added. Not that installation
  530.      has been difficult, but this will save some time and make an
  531.      eventual update easier to do.
  532.  
  533.      The fslogin.com file has been optimized. So it's even smaller
  534.      then it was before. There are however no functional differences
  535.      between fslogin.com (1.0) and fslogin.com (1.1). The two versions
  536.      can be mixed.
  537.  
  538.      The fslogin.ovl has been optimized as well. Despite the added
  539.      code for the accept button it is about 10 kb smaller.
  540.  
  541.      
  542.      Registration and support
  543.      ========================
  544.  
  545.      Feel free to use Full Screen Login for a trail period of 30 days.
  546.      After this period you are expected to register or stop using it. The
  547.      registration fee is based on a single file server licence. When used
  548.      on more servers, each server should have it's own licence.
  549.      Registration differs for the Netherlands, the United States and
  550.      other countries. When neither the Netherlands or the US apply to
  551.      you, you are expected to follow the US procedure, or contact Confirm
  552.      for another arrangement. See also the register.xx forms on the
  553.      distribution diskette or the archive file.
  554.  
  555.      Registered users are offered free support for at least a period of
  556.      half a year. They will receive a diskette with their 'customized'
  557.      version of FSLOGIN, which contains the name of the company and/or
  558.      department.
  559.      Registered users will also receive updates for a period of at least
  560.      half a year when new versions become available.
  561.      My preference for support is using either Compuserve mail, Telefax
  562.      or Fidonet (in this order). It is my go to answer all questions
  563.      within a reasonable amount of time.
  564.  
  565.      Compuserve  : 76260,2363
  566.      Telefax     : 31-8360-41580
  567.      Fidonet     : 2:512/250.359
  568.      Phone     : 31-8360-24988
  569.  
  570.      The Netherlands.
  571.      ----------------
  572.      Dutch users can register by paying DFL 200,00 Excluding 17.5% OB at
  573.      the Postbank account 2004075 of:
  574.  
  575.      Confirm
  576.      Ardèchelaan 35
  577.      6904 NG ZEVENAAR
  578.      The Netherlands
  579.  
  580.      The United States
  581.      -----------------
  582.      Users in the United States and other countries register by paying
  583.      US$ 125,00 at Visacard 4563 5303 9038 8376 of A.A. Slingerland.
  584.  
  585.      Any comment, criticism or idea is welcome, as long as it is in a
  586.      constructive way.
  587.  
  588.      Aad Slingerland
  589.      februari 1993
  590.  
  591.      End Of Document
  592.